Modulate Color (a filter plug-in for Adobe Photoshop™ 3.0)
Free 68k version 1.0.0. Copyright 1996 Hugh Kawahara. All rights reserved.
§ 0. Quick Start (This section should be enough for most people.)
0.1 Distribution Policy (Yes, it's free!)
This 68k version is a freeware. Please read § 1 for the detail.
0.2 System Requirement
Any Macintosh computer running Adobe Photoshop™ 3.0.0 or later.
0.3 Installation
Move the entire "Modulate_Color" folder into the "Plug-ins" folder in your "Adobe Photoshop™" folder. (Re)Start Photoshop. It will appear under the menu "Filter->colleen".
0.4 What It Does
It works on RGB images only. It adds or subtract the mask value from the hue, saturation,
and brightness values of the pixel. You need to create a density mask (a mask that contains
values between 0 and 255) to fully utilize this plug-in. With a simple mask (0 and 255 only)
or without a mask, it works very similar to the "Hue/Saturation" adjustment.
0.5 Usage
Set the amount of effect on the hue, saturation, and brightness using the three sliders on the
dialog window. Choose the adjustment range of ±100% or ±500% by the radio buttons.
The plug-in creates a small thumb nail in the dialog box for quick preview and a full size preview window over the original image window. Both previews are zoomable and scrollable
and the full size preview is resizable. The original image window still exists behind the full
size window. Use the "Glass" and "Hand" tools in the dialog box to zoom in/out or scroll the
previews. Double clicks to the toolbox fit/zoom-in the thumb nail preview. Double click while
holding down the option key fits/zoom-in the full size preview. Hold down the option key and
click on the "Cancel" button to reset all parameters.
0.6 How to Reach the Author
Please send comments, bug reports, etc. to <kawahara@leland.stanford.edu>.
Visit <http://www-leland.stanford.edu/~kawahara> for updates.
0.7 Examples
0.7.1 Difference between the "Hue/Saturation" adjustment and "Modulate Color" filter.
To see the difference, try the following:
1) Create a new RGB image.
2) Set the foreground and the background color to red and white, respectively.
3) Fill the entire image with the foreground color (i.e. red).
4) Go to the quick mask mode (just type 'q').
6) Using the gradient tool, create a gradient from the left side to the right side.
The options for the gradient tools should be "Normal", "Foreground to Background",
"Linear", opacity = 100%, and midpoint = 50%.
6) Exit from the quick mask mode (type 'q' again).
This should create a density mask which changes the value from 0 to 255 from the left
side to the right side. Only the right half will be surrounded by the selection border.
7a) Apply the "Hue/Saturation" adjustment with Hue = +180°. Or...
8b) Apply "Modulate Color" filter with Hue = +50%.
The image on the left is the result by the "Hue/Saturation" and the one on the right is by
"Modulate Color". The Hue/Saturation simply mixes red and cyan and de-saturate the image
at the center, while "Modulate Color" keeps the saturation constant and change the hue.
0.7.2 Simple Examples
The far left is the original picture with a tree and a blue sky. "Modulate Color" was applied
to the second left one with a simple gradient mask on the sky with Hue = +100%. On the third
picture, a gray scale copy of the image was used as a mask and the filter was applied with
Hue = -500%. On the far right picture, the gray scale copy was filtered by the "Find Edges"
and inverted. Using this grays scale image as a mask, the filter was applied with Hue = +60%.
0.7.3 Funky Text Effect
Try the following:
1) Create a new RGB image.
2) Set the foreground color to red (or any other very saturated color).
3) Fill the entire image with the foreground color (i.e. red).
4) Type something with 100 point Chicago. This will create a selection.
5) Feather (on the "Select" menu) the selection by 3 pixels.
6a) Apply "Modulate Color" with Hue = + 100%. Or...
6b) Apply "Modulate Color" with Hue = + 100% and Brightness = -100%.
User's Guide
Contents
1. Distribution Policy and Legal Stuff
2. System Requirement
3. Installation
4. What It Does
5. Usage
6. Misc. Notes
7. How to Reach the Author
8. Acknowledgment
§ 1. Distribution Policy and Legal Stuff
This particular version (the version is specified at the top of this document) is a freeware.
Other versions may not be. You may distribute this software freely as far as no parts of the
contents of the folder "Modulate_Color", which includes this memo "Modulate_Color.doc" and
the plug-in "Modulate_Color.68k", are deleted or modified.
The author retains the copyright. This software is provided "as is".
The author shall not be liable for any damages or losses caused by this software in any way.
§ 2. System Requirement
Hardware:
Macintosh computer with MC68020 processor or greater, including Power PC.
Math co-processor (FPU) is NOT required.
Software:
System 7.0 or greater.
Adobe Photoshop™ 3.0.0 or greater.
Since Photoshop 3.0 requires MC68020 and System 7.0, any Macintosh computers running Photoshop 3.0.0 or greater should be sufficient to run this plug-in.
It will not work with prior versions of Photoshop.
§ 3. Installation
Simply move, copy, or drag the entire "Modulate_Color" folder containing the plug-in and
this memo into the "Plug-ins" folder in your "Adobe Photoshop™" folder.
Quit Photoshop if it is running. Then (re)start Photoshop.
It will appear under the menu "Filter->colleen".
§ 4. What It Does
4.1 Image Mode
RGB images only.
4.2 What It Really Does
It adds or subtract the mask value from the hue, saturation, and brightness values of the
pixel. If there is no selection, the mask value is taken to be 255. If the mask is a simple
selection, i.e. does not contains any values other than 0 and 255, it works very similar to
the "Hue/Saturation" adjustment. Therefore, it is essential to use density masks (masks
not restricted to value 0 or 255) to fully utilize this plug-in.
The saturation and brightness controls work very similar to the "Hue/Saturation" adjustment.
Those two adjustments are provided for convenience and completeness.
The main difference is the way it works on the hue. The mask value determines the amount
of hue modulation rather than the opacity of the effect as in the "Hue/Saturation" adjustment.
For example, with this plug-in, the saturation of the resulting image is always 100%
regardless of the mask value if the saturation of the original image is 100%, while it is
less than 100% in case of the "Hue/Saturation" adjustment unless the mask value is 100%.
The mask value is multiplied by the slider settings, then added to the hue, saturation, and
brightness values of the image. If the resulting saturation or brightness is over 100% (255)
or under 0%, the plug-in truncates it to 100% or 0%. In case of the hue, the result is the
modulo of 360° (256).
§ 5. Usage
5.1 Invocation
Simply choose "Modulate Color…" from the menu "Filter->colleen".
5.2 Adjusting the Amount of Modulation
Use the "Hue", "Saturation", and "Brightness" sliders.
5.3 Selecting the Adjustment Range
Use the "±100%" or "±500%" radio button. The adjustment values will be always confined
within the adjustment range.
5.4 Resetting the Settings
Clicking the "Cancel" button while pressing the option key resets all parameters to zero.
5.5 Previews
The plug-in creates two previews. One is a small thumb nail in the dialog box
and other one is a full size preview over the original image window.
The full size preview window is a separate window from the original image window.
To view the original image, just drag the preview window.
Both previews are zoomable and scrollable. The full size preview is resizable too.
Use the "Glass" tool to zoom-in/out the preview. Use the "Hand" tool or the scroll bars
to scroll the preview. Press the option key to zoom out. Press the command key to zoom in.
The maximum zoom-in ration is 1:1 at this moment.
To choose a tool, click the toolbox in the dialog window.
Double click the "Hand" tool to fit the thumb nail preview to the preview area.
Press the option key while double clicking to fit the full size preview to the window.
Double click the "Glass" tool to zoom in the thumb nail preview to 1:1 ratio.
Press the option key while double clicking to zoom in the full size preview.
The double clicks do not resize the window .
(Note: The thumb nail preview is "buffered" for quick refresh.
Any zooming or scrolling may take some time to re-buffer the data from Photoshop, if the image is large.)
§ 6. Misc. Notes
6.1 Masking the Effect
Since this plug-in uses the mask as a "modifier", you can't mask the effect in a usual way.
One way to do this would be to create another layer and use a layer mask.
§ 7. How to Reach the Author
Please send comments, bug reports, etc. to <kawahara@leland.stanford.edu>.
Visit <http://www-leland.stanford.edu/~kawahara> for updates.
§ 8. Acknowledgment
This software was developed using
Metrowerks CodeWarrior Academic 7 and
Adobe Photoshop 3.0.4 SDK.
Adobe Photoshop is a trademark of Adobe Systems, Inc..
Macintosh is a trademark of Apple Computer, Inc..
Metrowerks CodeWarrior is a trademark of Metrowerks, Inc..
